package com.mytecblog.framework.dao.query;

import com.mytecblog.framework.entity.MetaObject;

import java.util.List;
import java.util.Map;

/**
 * 数据库查询接口
 * @author yg.huang
 * @version v1.0
 *          DATE  2016/10/28
 */
public interface DBQuery<T extends MetaObject> {
    /**
     * 得到查询字符串
     * @return
     */
    String getQueryString();

    /**
     * 设置分页第一条索引
     * @param firstResult
     */
    void setFirstResult(int firstResult);

    /**
     * 设置最大结果
     * @param maxResult
     */
    void setMaxResult(int maxResult);

    /**
     * 设置查询参数
     * @param name 参数名
     * @param value 参数值
     */
    DBQuery setParameter(String name, Object value);

    /**
     * 设置全部查询参数
     * @param parameters 参数集
     */
    DBQuery setParameters(Map parameters);

    /**
     * 得到所有查询参数
     * @return
     */
    Map getParameters();

    /**
     * 得到查询结果数量
     * @return
     */
    int getResultCount();

    /**
     * 得到查询结果
     * @return
     */
    List<T> getResult();

    /**
     * 设置排序
     * @param orderBy
     */
    void setOrderBy(String orderBy);

    /**
     * 设置默认排序
     * @param defaultOrderBy
     */
    void setDefaultOrderBy(String defaultOrderBy);

    /**
     * 得到唯一的结果
     */
    T uniqueResult();
}
